Sound Data Management12

This section describes functions for managing sound data. These functions apply to all derived media handler components.

MediaSetSoundLocalizationData

If you are creating a media handler that plays sound and wish to support 3D sound capabilities, you need to implement the MediaSetSoundLocalizationData routine.



 
pascal ComponentResult MediaSetSoundLocalizationData (MediaHandler mh, Handle data)

mh: Identifies the Movie Toolbox's connection to your derived media handler.
data: The data passed to your media handler, in the format of a sound sprockets SSpLocalizationData record.

Discussion

This routine is passed a handle containing the new SSpLocalizationData record to use. If the handle is nil , it indicates that no 3D sound effects should be used. If you implement this routine, and return noErr as the result, it is assumed that your media handle assumes responsibility for disposing of the data handle passed. If the implementation of this routine returns an error, the caller will dispose of the handle. This behavior is implemented to minimize the copying of the settings handle, making it easier for developers to implement the MediaSetSoundLocalizationData function.

The MediaSetSoundLocalizationData will be called regardless of whether the 3D sound settings were set on the track using SetTrackSoundLocalizationSettings or via the modifier track mechanism.